home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm1 / gshufl11.zip / SHUFFLE.DOC < prev    next >
Text File  |  1993-05-13  |  14KB  |  326 lines
  1.  
  2.           
  3.  
  4.  
  5.           
  6.           
  7.                    Forum_Shuffle - The Forum Arranger for GAP
  8.                     
  9.            Copyright (c) 1993 RoboSoft Systems. All Rights Reserved.
  10.                     
  11.           
  12.           Forum_Shuffle will allow you to quickly and easily change the
  13.           arrangement of the forums on your GAP BBS.  It will do
  14.           everything except update your menus.  All you have to do is
  15.           figure out what order you want the forums in and Forum_Shuffle
  16.           will do the rest, including rearranging all the files required
  17.           for GAPQWK and MainMail.
  18.           
  19.           
  20.           Disclaimer 
  21.           ----------
  22.           
  23.           Forum_Shuffle is provided AS IS without any warranty,
  24.           expressed or implied, including, but not limited to, fitness
  25.           for any purpose.  Use of Forum_Shuffle, and the consequences
  26.           thereof, are entirely your risk.  In no event will RoboSoft
  27.           Systems be liable for any damages whatsoever resulting from
  28.           the use of Forum_Shuffle.
  29.           
  30.           
  31.           Shareware
  32.           ---------
  33.           
  34.           Forum_Shuffle is a Shareware product.  As such, it is made
  35.           available to the GAP sysop community for evaluation.  Users
  36.           are licensed to operate this program on their computers for
  37.           the purpose of test and evaluation on a trial basis for 30
  38.           days.  If Forum_Shuffle is used after the first 30 days,
  39.           registration with RoboSoft Systems is required.
  40.           
  41.           The unregistered version of Forum_Shuffle has a number of
  42.           restrictions not present in the registered version.  See the
  43.           end of this file for a list of the restrictions.
  44.           
  45.           
  46.           
  47.           Registration
  48.           ------------
  49.           
  50.           Registered users are those users who elect to pay for
  51.           Forum_Shuffle and register that payment with RoboSoft Systems.
  52.           By virtue of registration and payment for the program,
  53.           registered users are granted a license to continue to utilize
  54.           the program on their personal computer for as long as they
  55.           choose.  This license authorizes use of the program on any
  56.           personal computer system the user may own or use so long as
  57.           the program is operated on only one computer system at a time.
  58.           Use on multiple systems simultaneously requires multiple
  59.           registrations.
  60.           
  61.           The registration fee for Forum_Shuffle is $15.  Please make
  62.           checks payable to:
  63.  
  64.  
  65.                                      Page 1                           
  66.  
  67.           Forum_Shuffle v1.1                                   5/13/93
  68.  
  69.  
  70.           
  71.                                 RoboSoft Systems
  72.                                  P.O. Box 2221
  73.                                 Orange, CA  92669
  74.           
  75.           The payment of this registration fee to RoboSoft Systems
  76.           entitles the user to full use of Forum_Shuffle for an
  77.           unlimited period of time.  Registered users will receive a
  78.           disk with the registered verison of Forum_Shuffle, and a
  79.           registration key file that will unlock ALL the program
  80.           features and remove the demo restrictions.  See REGISTER.DOC
  81.           for complete registration information.
  82.           
  83.           
  84.           Updates
  85.           -------
  86.           
  87.           Updates to Forum_Shuffle will be provided via BBS free of
  88.           charge to registered users.  Updates on diskette are available
  89.           for a nominal charge to cover materials and handling.
  90.           
  91.           
  92.           Support
  93.           -------
  94.           
  95.           Support for Forum_Shuffle is available on The Cookie Jar BBS
  96.           at 714-997-0350.  Registered users will be granted access to
  97.           the private node of the BBS and will be given priority in
  98.           having their questions answered.
  99.           
  100.           
  101.           Distribution
  102.           ------------
  103.           
  104.           Forum_Shuffle may be freely distributed on any Bulletin Board
  105.           System (BBS), including commercial systems such as CompuServe
  106.           (CIS), Genie, and BIX.  Forum_Shuffle may be distributed by
  107.           diskette by any organization or disk distributor as long as
  108.           the fee for this distribution is no greater than $5 and it is
  109.           made clear to the purchaser that the distribution fee is NOT
  110.           the same as the registration fee.
  111.           
  112.           Feel free to pass around copies of Forum_Shuffle, however,
  113.           please distribute all of the original files and do not modify
  114.           any of the files.
  115.           
  116.           
  117.           How do I use this thing?
  118.           ------------------------
  119.           
  120.           Before you begin to use Forum_Shuffle, you need to decide what
  121.           you want the new forum ordering to be.  It is suggested that
  122.           you write it all out on paper before you fire up Forum_Shuffle.
  123.           
  124.           Forum_Shuffle will not allow you to add new forums or delete
  125.           existing forums; it only shuffles existing forums.  If you
  126.           want to add new forums in the middle of your forum list, use
  127.           GAPSETUP to add the new forums to the end of the list and then
  128.  
  129.  
  130.                                      Page 2                           
  131.  
  132.           Forum_Shuffle v1.1                                   5/13/93
  133.  
  134.  
  135.           use Forum_Shuffle to move the forums where you want them to
  136.           be.  If you want to delete some forums, use Forum_Shuffle to
  137.           move those forums to the very end of the list, then use
  138.           GAPSETUP to change the number of forums to effectively exclude
  139.           the deleted forums.
  140.           
  141.           When you run Forum_Shuffle, you'll first see a welcome screen.
  142.           Then there's a warning about multi-user restrictions.
  143.           Forum_Shuffle is NOT multi-user.  You can use it on multi-node
  144.           systems, but all nodes must be offline when you run
  145.           Forum_Shuffle.  You're given a chance to exit at this point if
  146.           you haven't brought down all your nodes.
  147.           
  148.           Then you come to the main Forum_Shuffle screen.  This is a
  149.           listing of all your forums (the screen will scroll if you have
  150.           more forums than can be displayed on a single screen).  Down
  151.           the left side of the screen are the names and numbers of your
  152.           forums in their current order.  Down the right side of the
  153.           screen are the names and numbers of the forums in their new
  154.           order (which will be the same as the left column initially).
  155.           
  156.           The column of numbers in the middle of the screen is where you
  157.           indicate the new forum ordering.  Just go down this column and
  158.           enter the new forum number for the forum listed on the left
  159.           side of the screen.  As you enter new forum numbers, the
  160.           listing on the right will change to reflect the new order.
  161.           Because of the swapping done by Forum_Shuffle while you're
  162.           changing the ordering, the right hand column may look horribly
  163.           out of order while you're in the middle of the process.  Don't
  164.           panic!  Just continue entering your new forum ordering.  When
  165.           you've entered all the forum numbers, then take a look at the
  166.           right hand column and see if it's what you intended.
  167.           
  168.           At this point in the process nothing has actually been
  169.           changed.  When you've got the new order the way you want it,
  170.           press ESCape or click on the upper left hand box with your
  171.           mouse.  You'll then be asked if you want to commit these
  172.           changes or cancel the whole procedure.  You can safely cancel
  173.           at this point and nothing within your GAP system will have
  174.           been changed.  Once you begin the commit process, there's no
  175.           going back.  It MUST run to completion or you'll end up with a
  176.           real mess.  (Forum_Shuffle DOES make backups of all the
  177.           critical files before changing anything so you can restore the
  178.           old ordering if necessary.)
  179.           
  180.           Once you've begun the commit process, Forum_Shuffle will start
  181.           making all the necessary changes to the GAP data files.  This
  182.           process may take anywhere from a few minutes to well over an
  183.           hour, depending upon how many forums you have, how many users
  184.           you have, and how fast your equipment is.  (I have 95 forums,
  185.           about 1500 users, and a 386-33.  Shuffling my forums takes
  186.           about 15 minutes.)
  187.           
  188.           As the forum data is being updated, you'll see a status screen
  189.           that can give you some idea of how far along things are.
  190.           
  191.           Once the process completes, all you have left to do is update
  192.           your menus.
  193.  
  194.  
  195.                                      Page 3                           
  196.  
  197.           Forum_Shuffle v1.1                                   5/13/93
  198.  
  199.  
  200.           
  201.           WHAT IF SOMETHING GOES WRONG?
  202.           
  203.           Before any changes are made to the GAP control files,
  204.           Forum_Shuffle makes backups of all the affected files.
  205.           Specifically, these are FORUM.DAT, MEMBER.DAT, and MESSNO.DAT.
  206.           The backups all have the same root as the backed up file only
  207.           with the extension of .OLD.  If something catastrophic happens
  208.           part way through the shuffle, do the following:
  209.           
  210.             1) CD to the GAP\MAIN directory.
  211.             2) Type: copy forum.old forum.dat
  212.             3) Type: del forum.idx
  213.             4) Type: copy member.old member.dat
  214.             6) Type: copy messno.old messno.dat
  215.             6) If you run MainMail, type: copy mmdat.old mmdat.cnf
  216.             7) If you use GAPNet
  217.                7A) Type: copy qwkforum.old qwkforum.dat
  218.                7B) Type: del qwkforum.idx
  219.             8) If files.old exists and has a current date
  220.                8A) Type: copy files.old files.dat
  221.                8B) Type: del files.idx
  222.             9) CD to the GAP default directory
  223.            10) Type: GAPREBLD
  224.             
  225.           Once you've determined that everything is fine following the
  226.           run through Forum_Shuffle, you can delete the .OLD backup
  227.           files.
  228.           
  229.           A FEW POTENTIAL PROBLEMS
  230.           
  231.           While the forum rearrangement process will be largely 
  232.           invisible to your QWKmail callers, there is one potential 
  233.           problem.  Forum_Shuffle will make sure that if a caller had 
  234.           the Blotz forum selected in GAPQWK or MainMail when it was 
  235.           forum #15 he'll still get the Blotz forum now that it's 
  236.           been changed to be forum #117.  But, if the caller uploads 
  237.           replies from before the change, his Blotz forum replies will 
  238.           go to whatever is now forum #15 and not to forum #117 where 
  239.           the Blotz forum now resides.  This will only happen on the 
  240.           mail run immediately after you change your forums.  Once the 
  241.           caller downloads a new mail packet with the Blotz forum as 
  242.           #117, his replies will properly go to forum #117.
  243.           
  244.           Unfortunately, there's not a really good solution for this.  
  245.           About the best you can do is give your users sufficient 
  246.           warning and hope for the best.  If you're so inclined, it may 
  247.           help to either hold off on mail runs for a couple days prior 
  248.           to the change or to disallow downloads of new mail from the 
  249.           forums you plan to change.  It's unlikely there will be a lot 
  250.           of replies or new messages uploaded if there was no mail 
  251.           downloaded.
  252.           
  253.           For those of you who are net-mail hubs, you will need to alert 
  254.           your nodes to the changes you plan to make and to when you 
  255.           plan to make them.  The nodes will need to change the forum 
  256.           mappings on their end at the same time you make your changes.  
  257.           We're working on some ways to automate this process, but it 
  258.  
  259.  
  260.                                      Page 4                           
  261.  
  262.           Forum_Shuffle v1.1                                   5/13/93
  263.  
  264.  
  265.           will most likely only work for those nodes using GAPNet.  
  266.           Those running non-GAP software will be left to their own 
  267.           devices.
  268.           
  269.           For those of you using Postlink or PCRelay, sorry, but 
  270.           Forum_Shuffle can't automatically change any of the Postlink 
  271.           or PCRelay files.  It is extremely unlikely that Forum_Shuffle 
  272.           will ever support either of these programs, however, I've been
  273.           told the Postlink "tmanage" program will take care of the
  274.           changes as long as all your forums have unique names.  I don't
  275.           use Postlink so I can't help with the changes required for it, 
  276.           but the "tmanage" information came from a very reliable source.
  277.           
  278.           
  279.           SPECIAL NOTE ABOUT THE DEMO VERSION: The demo version of
  280.           Forum_Shuffle has a few restrictions of which you should be
  281.           aware.  It will only allow five forums to be changed on any
  282.           given run of the program.  Also, the update to the databases
  283.           has been purposely slowed down.  The registered version runs
  284.           about three times faster than the demo version.  It is
  285.           regrettable that such devices must be employed to encourage
  286.           registration, but "invisible" utilities such as Forum_Shuffle
  287.           have a poor registration rate if very persuasive registration
  288.           encouragements are not used.
  289.            
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                      Page 5                           
  326.